IPS Server command line: Options for advanced configuration and troubleshooting
The IPS server program 'Palantir.IPS.Server.exe' has a command line mode which can be helpful for performing non-standard installations, or for troubleshooting IPS server operational issues.
Configuration of the IPS service
The following table shows the options that are used for installation and configuration of the IPS service.
| Command line option | Explanation |
|---|---|
| /install | Use this switch to install the IPS service. |
| /uninstall | Use this switch to uninstall the IPS service. Specify the name of the service to uninstall using the /servicename argument. |
| /servicename | Name of the IPS service as it will appear in the operating system. Please ensure the first eight characters of the name are unique. If this argument is not set, 'PalantirIPS' will be used. |
| /displayname | Name of the IPS service as displayed in the list of Windows services. If this argument is not set, the value for /servicename will be used as the display name. |
| /setserviceaccount | Add this switch to use a specific account to run the IPS service (this will prompt the user to enter the account details), or use the options '/username' and '/password'. |
| /username | Username of the IPS service account. |
| /password | Password of the IPS service account. |
| /installlogfile | Filename for the installation log file. |
| /appdatafolder | File system location for the IPS server config file, and Planning Space application files. |
| /enablepackageupdate | Use this switch to enable the syncing of Planning Space application binaries during server startup. |
Note that options with arguments use the '=' sign, for example:
.\Palantir.IPS.Server.exe /install /setserviceaccount /username=DOMAIN\User /password=XXXXX
/appdatafolder="C:\ProgramData\Palantir\PalantirIPS 16.5"Troubleshooting
The following table shows the options used for administration and troubleshooting purposes.
| Command line option | Explanation |
|---|---|
| /noservice | Use this switch to run IPS server as a console application instead of as a Windows service. |
| /appdatafolder | File system location for the IPS server config file, and Planning Space application files. |
| /enablepackageupdate | Use this switch to enable the syncing of Planning Space application binaries during server startup. |
| /forcelogtofile | When running IPS as a console application, by default application server log messages are written to the console window. When this switch is on, the log messages will be written to their respective log files. |
For example, to run the IPS Server as a console application:
.\Palantir.IPS.Server.exe /noservice /appdatafolder="C:\ProgramData\Palantir\PalantirIPS 16.5"The IPS server will be running and available when you see the output line 'Palantir services are available. Press <ENTER> to exit.'
Also important for troubleshooting are the IPS and Planning Space log files which are stored in the 'appdatafolder' (by default: 'C:\ProgramData\Palantir\PalantirIPS 16.5\Logs').